Skip to main content
PATCH
/
creatives
Update a creative
curl --request PATCH \
  --url https://your_a2_service/creatives \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "banner": {
    "ext": {},
    "img": "",
    "link": {
      "ext": {},
      "url": ""
    }
  },
  "cid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "height": 123,
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "native": {
    "ext": {},
    "link": {
      "ext": {},
      "url": ""
    }
  },
  "owner_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "inactive",
  "type": "banner",
  "updated_at": "2023-11-07T05:31:56Z",
  "video": {
    "adm": "",
    "ctype": 2,
    "dur": 0,
    "ext": {
      "cdn": "",
      "linear": 1,
      "link": {
        "ext": {},
        "url": ""
      },
      "url": ""
    },
    "mime": ""
  },
  "width": 123
}'
{
  "banner": {
    "ext": {},
    "img": "",
    "link": {
      "ext": {},
      "url": ""
    }
  },
  "cid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "height": 123,
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "native": {
    "ext": {},
    "link": {
      "ext": {},
      "url": ""
    }
  },
  "no": 123,
  "owner_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "inactive",
  "type": "banner",
  "updated_at": "2023-11-07T05:31:56Z",
  "video": {
    "adm": "",
    "ctype": 2,
    "dur": 0,
    "ext": {
      "cdn": "",
      "linear": 1,
      "link": {
        "ext": {},
        "url": ""
      },
      "url": ""
    },
    "mime": ""
  },
  "width": 123
}

Authorizations

โ€‹
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Represents a updating creative entity.

โ€‹
id
string<uuid>
required

The id of creative

โ€‹
name
string
required

The name of creative

โ€‹
owner_id
string<uuid>
required

The owner's id of creative

โ€‹
type
enum<string>
required

The type of creative

Available options:
banner,
video,
native
โ€‹
banner
object

Represents a banner creative with image, link, and optional extensions.

โ€‹
cid
string<uuid> | null

The id of the campaign the creative is used in

โ€‹
created_at
string<date-time>

The time the creative was created

โ€‹
description
string | null

The creative's description

โ€‹
height
integer | null
default:0

The height that will be shown

โ€‹
native
object

Represents a native creative with link and optional extensions.

โ€‹
status
enum<string>
default:inactive

The status of creative

Available options:
active,
inactive
โ€‹
updated_at
string<date-time>

The time the creative was updated

โ€‹
video
object

Represents a video creative with MIME type, URL, and optional extensions.

โ€‹
width
integer | null
default:0

The width that will be shown

Response

Successful Response

Represents a reading creative entity.

โ€‹
id
string<uuid>
required

The id of creative

โ€‹
name
string
required

The name of creative

โ€‹
no
integer
required

The no of creative

โ€‹
owner_id
string<uuid>
required

The owner's id of creative

โ€‹
type
enum<string>
required

The type of creative

Available options:
banner,
video,
native
โ€‹
banner
object

Represents a banner creative with image, link, and optional extensions.

โ€‹
cid
string<uuid> | null

The id of the campaign the creative is used in

โ€‹
created_at
string<date-time>

The time the creative was created

โ€‹
description
string | null

The creative's description

โ€‹
height
integer | null
default:0

The height that will be shown

โ€‹
native
object

Represents a native creative with link and optional extensions.

โ€‹
status
enum<string>
default:inactive

The status of creative

Available options:
active,
inactive
โ€‹
updated_at
string<date-time>

The time the creative was updated

โ€‹
video
object

Represents a video creative with MIME type, URL, and optional extensions.

โ€‹
width
integer | null
default:0

The width that will be shown